home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-9.10-netbook-remix-PL.iso / casper / filesystem.squashfs / usr / share / doc / python-nevow / README < prev   
Encoding:
Text File  |  2006-06-14  |  2.8 KB  |  70 lines
  1.  
  2. Divmod Nevow
  3. ============
  4.  
  5. Divmod Nevow is a web application construction kit written in Python. It is
  6. designed to allow the programmer to express as much of the view logic as
  7. desired in Python, and includes a pure Python XML expression syntax named stan
  8. to facilitate this. However it also provides rich support for designer-edited
  9. templates, using a very small XML attribute language to provide bi-directional
  10. template manipulation capability.
  11.  
  12. Nevow also includes Divmod Athena, a "two way web" or "`COMET`_"
  13. implementation, providing a two-way bridge between Python code on the server
  14. and JavaScript code on the client.  Modular portions of a page, known as
  15. "athena fragments" in the server python and "athena widgets" in the client
  16. javascript, can be individually developed and placed on any Nevow-rendered page
  17. with a small template renderer.  Athena abstracts the intricacies of HTTP
  18. communication, session security, and browser-specific bugs behind a simple
  19. remote-method-call interface, where individual widgets or fragments can call
  20. remote methods on their client or server peer with one method: "callRemote".
  21.  
  22. Installation
  23. ------------
  24.  
  25. Before installing Nevow, you should install `Twisted`_, unless you are going to
  26. write very simple CGI applications. Nevow integrates fully with the twisted.web
  27. server providing easy deployment.
  28.  
  29. Nevow uses the standard distutils method of installation::
  30.  
  31.     python setup.py install
  32.  
  33. If you do not have Twisted installed, you can run a subset of the tests using
  34. the test.py script. If you have twisted installed, the test.py script will
  35. issue the following trial command::
  36.  
  37.     trial -v nevow.test formless.test
  38.  
  39. .. _`Twisted`: http://twistedmatrix.com/
  40.  
  41. Documentation
  42. -------------
  43.  
  44. More detailed introductory documentation is available in the doc/ directory,
  45. along with the beginnings of a reference manual. A large number of examples are
  46. available in the examples/ directory. These examples require Twisted to run. A
  47. tac file (twisted application configuration) can be started by invoking twistd,
  48. the twisted daemon::
  49.  
  50.     twistd -noy foo.tac
  51.  
  52. More Information
  53. ----------------
  54.  
  55. Nevow is an active project, and many new bugfixes and features are committed to
  56. the Nevow SVN repository. Information about Nevow commits is available by
  57. subscribing to the `Nevow commits`_ mailing list. The Nevow SVN repository can
  58. be checked out using::
  59.  
  60.   svn co http://divmod.org/svn/Divmod/trunk/Nevow Nevow
  61.  
  62. Discussion of Nevow occurs on the `twisted.web mailing list`_. The Nevow
  63. developers are also often available for real-time help on the `#twisted.web
  64. channel`_ on irc.freenode.net.
  65.  
  66. .. _`Nevow commits`: http://divmod.org/users/mailman.twistd/listinfo/nevow-commits
  67. .. _`twisted.web mailing list`: http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-web
  68. .. _`#twisted.web channel`: irc://irc.freenode.net/#twisted.web
  69. .. _`COMET`: http://alex.dojotoolkit.org/?p=545
  70.